home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmPrintPopupPDM.z / XmPrintPopupPDM
Text File  |  1998-10-30  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmPPPPrrrriiiinnnnttttPPPPooooppppuuuuppppPPPPDDDDMMMM((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmPPPPrrrriiiinnnnttttPPPPooooppppuuuuppppPPPPDDDDMMMM((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmPPPPrrrriiiinnnnttttPPPPooooppppuuuuppppPPPPDDDDMMMM - Send a notification for the PDM to be
  10.           popped up
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Print.h>
  14.           XXXXttttEEEEnnnnuuuummmm XXXXmmmmPPPPrrrriiiinnnnttttPPPPooooppppuuuuppppPPPPDDDDMMMM(
  15.           WWWWiiiiddddggggeeeettttpppprrrriiiinnnntttt____sssshhhheeeellllllll,
  16.           WWWWiiiiddddggggeeeettttvvvviiiiddddeeeeoooo____ttttrrrraaaannnnssssiiiieeeennnntttt____ffffoooorrrr);
  17.  
  18.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  19.           This page documents Motif 2.1.
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.           A convenience function that sends a notification to start a
  23.           Print Dialog Manager on behalf of the application,
  24.           XXXXmmmmPPPPrrrriiiinnnnttttPPPPooooppppuuuuppppPPPPDDDDMMMMhides the details of the X selection
  25.           mechanism used to notify the PDM that a new dialog must be
  26.           popped up for this application.
  27.  
  28.           XXXXmmmmPPPPrrrriiiinnnnttttPPPPooooppppuuuuppppPPPPDDDDMMMM sends a selection request to either the
  29.           print display of the print shell, or the video display of
  30.           the transient_for video widget (depending on the environment
  31.           variable _X_P_D_M_D_I_S_P_L_A_Y, which can only takes the value "print"
  32.           or "video"), asking for the PDM windows to be popped up on
  33.           behalf of the app.
  34.  
  35.           Return right away with status of _X_m_P_D_M__N_O_T_I_F_Y__F_A_I_L(e.g. if
  36.           the function couldn't malloc memory for the selection value,
  37.           or if _X_P_D_M_D_I_S_P_L_A_Yis not "print" or "video") or with
  38.           _X_m_P_D_M__N_O_T_I_F_Y__S_U_C_C_E_S_S, which only means a "message" was sent
  39.           out to the PDM specified by _X_P_D_M_S_E_L_E_C_T_I_O_N, not that it's
  40.           already up on the screen yet.
  41.  
  42.           In order to know if the PDM is up, or not running, the
  43.           application must register a XXXXmmmmNNNNppppddddmmmmNNNNoooottttiiiiffffiiiiccccaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkwith
  44.           the Print Shell.
  45.  
  46.           XXXXmmmmPPPPrrrriiiinnnnttttPPPPooooppppuuuuppppPPPPDDDDMMMM puts up an IIIInnnnppppuuuuttttOOOOnnnnllllyyyywindow on top of the
  47.           dialog, so that the end user doesn't use the print setup
  48.           dialog while the PDM is trying to come up. This window is
  49.           automatically removed when the shell is about to call the
  50.           callback for the first time.
  51.  
  52.           _p_r_i_n_t__s_h_e_l_l
  53.                     The Print Shell used for this print job and
  54.                     context.
  55.  
  56.           _v_i_d_e_o__t_r_a_n_s_i_e_n_t__f_o_r
  57.                     The video widget dealing with application print
  58.                     setup.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmPPPPrrrriiiinnnnttttPPPPooooppppuuuuppppPPPPDDDDMMMM((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmPPPPrrrriiiinnnnttttPPPPooooppppuuuuppppPPPPDDDDMMMM((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  75.           Returns _X_m_P_D_M__N_O_T_I_F_Y__S_U_C_C_E_S_S if the function was able to
  76.           send the notification out to the PDM process,
  77.           _X_m_P_D_M__N_O_T_I_F_Y__F_A_I_L otherwise.
  78.  
  79.      EEEERRRRRRRROOOORRRRSSSS////WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  80.           Not applicable.
  81.  
  82.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  83.           Example of callback from a Print set up dialog box
  84.           "Setup..." button:
  85.  
  86.           PrintSetupCallback(print_dialog...)
  87.           /*-------------*/
  88.           {
  89.               if (XmPrintPopupPDM (pshell, XtParent(print_dialog)) !=
  90.                                               XmPDM_NOTIFY_SUCCESS) {
  91.                   /* some error dialog */
  92.               }
  93.           }
  94.  
  95.           Example of XXXXmmmmNNNNppppddddmmmmNNNNoooottttiiiiffffiiiiccccaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk from a Print Shell:
  96.  
  97.           pdmNotifyCB(print_shell...)
  98.           {
  99.               XmPrintShellCallBackStruct * pr_cb = ...
  100.  
  101.               switch (pr_cb->reason) {
  102.                  case XmCR_PDM_NONE:
  103.                      /* no PDM available */
  104.                      PostErrorDialog(...);
  105.                      break;
  106.                  case XmCR_PDM_VXAUTH:
  107.                      /* PDM is not authorized ... */
  108.                      PostErrorDialog(...);
  109.                      break;
  110.                  case XmCR_PDM_UP: the PDM is up and running
  111.                      /* everything is fine */
  112.                      break;
  113.                          default: /* other cases */
  114.              }
  115.           }
  116.  
  117.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  118.           XXXXmmmmPPPPrrrriiiinnnnttttSSSSeeeettttuuuupppp(3), XXXXmmmmPPPPrrrriiiinnnnttttSSSShhhheeeellllllll(3), XXXXmmmmRRRReeeeddddiiiissssppppllllaaaayyyyWWWWiiiiddddggggeeeetttt(3),
  119.           XXXXmmmmPPPPrrrriiiinnnnttttTTTTooooFFFFiiiilllleeee(3)
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.